Tenant Services Provisioning Overview

Tenant Services exposes the CLI and REST API for automating the Tenant network configuration on the Clos and non-Clos (small data center) overlay fabric.

Tenant network configuration includes VLAN, BD, VE, EVPN, VTEP, VRF, and Router BGP configuration on the necessary fabric devices to provide L2-Extension, L3-Extension across the fabric, L2-Handoff, and L3-Handoff at the edge of the fabric.

Tenant Services provisioning automates the Tenant configuration, which can be a subset of the combinations provided by the switching hardware.

Tenant Services supports multiple fabrics.

Note

You cannot perform fabric and tenant operations when manual DRC is in progress.

Tenant

A Tenant is a logical construct that owns resources as follows:

VLAN range: Ctags pertaining to which the traffic is expected to ingress and egress.

Note
Customer VLAN tag (Ctag) is used to identify the customer broadcast domain. In the IP fabric network, it represents the customer and is mapped into a VXLAN tunnel through a virtual network identifier (VNI). The VNI is the ID used to identify the VXLAN tunnel. With auto VNI mapping, the Ctag ID equals the VNI. You can also manually map Ctags to user-defined VNIs. These VNIs can be mapped to VLAN IDs (up to 4k) or to BD‘s (bridge domain) IDs.
Device ports: Ports on which the traffic is expected to ingress and egress.

VLAN-based Tenant

For a VLAN-based tenant, realization of network on the device is done using VLAN and switchport VLANs. Bridge domains are used for EVPN IRB.

Bridge domain-based Tenant

For a BD-based tenant, realization of network on the device is done using BD and BD-LIF. BD is used for EVPN IRB.

Scalability

Table 1. VNI scalability
VNI type	Scale
Non-auto VNI mapping	The number of VNI (networks) supported per device = 8K [4K VLAN + 4K BD] The maximum number of VNI (networks) supported in the fabric = [8K * number of devices in the fabric].
Auto VNI mapping	The number of VNI (networks) supported per device = 8K [4K VLAN + 4K BD] The number of VNI (networks) supported per fabric = 8K

Event handling

Event handling specifies the scope of the tenant configuration on the devices.

Devices are added to the Tenant service only when the fabric is provisioned on the devices.

An event is an occurrence of a device being removed from the fabric or from the Inventory.

When a device is removed from the fabric or inventory, the device is cleaned up from Tenant Service and the Tenant configuration is removed from the device.
User-created entities, such as Tenant, VRF, and Endpoint Group, are not deleted whereas references for ports or port-channels of deleted devices are removed.